Wintersemester 2005/2006

FernUniversität Hagen Fachbereich Informatik

Schnelleinstieg Tomcat

Im Folgenden wird erläutert, wie der Web Container Tomcat als Schnelleinstieg installiert, konfiguriert und gestartet wird. Dieser Vorgang kann im Vergleich zu anderen Web Containern wie z.B. Macromedia JRun oder Caucho Resin abweichen. Zu beachten gilt, dass es teilweise erhebliche Unterschiede zwischen den unterschiedlichen Versionen der Servlet-Spezifikation gibt. Beim Einsatz eines Web Container ist daher auf die jeweils implementierte Version der Spezifikation zu achten. Wir setzen in diesem Schnelleinstieg Windows XP Professional mit dem Java Development Kit 5.0 (JDK 5.0) sowie Tomcat in der Version 5.5.9 ein, der die aktuelle Servlet-Spezifikation 2.4 und JSP-Spezifikation 2.0 implementiert.

Tomcat selbst ist in Java geschrieben und somit auf allen Plattformen verfügbar, für die es ein JDK gibt. Da Tomcat zur Laufzeit Java-Code übersetzen muss (nämlich die Java ServerPages) und dazu der Compiler des JDK verwendet wird, ist ein JDK notwendig. Eine Java Runtime Environment (JRE) allein ist nicht ausreichend. Seit Version 4.0 heißt der Web Container übrigens intern Catalina, weswegen in den Log-Dateien und an anderen Stellen nicht der Name Tomcat, sondern stattdessen Catalina auftaucht.

1. Installation des JDK 5.0
2. Installationsanleitung für Tomcat 5.5.9 (ausführbare Installationsdatei)
3. Installationsanleitung für Tomcat 5.5.9 (zip-Datei)
4. Tomcat-Verzeichnisse: die wichtigsten Verzeichnisse und Dateien werden kurz erläutert
5. Hello World!: Erstellung und Deployment des klassischen Hello World Beispiels

Befolgen Sie bitte entweder Abschnitt zwei oder Abschnitt drei, nicht aber beide. Für Linux-Nutzer ist aufgrund des Fehlens einer ausführbaren Installationsdatei der zweite Abschnitt maßgeblich, auch wenn sich das Beispiel an Windows orientiert.

Zunächst benötigt man die beiden Pakete

• JDK 5.0 sowie
• Tomcat 5.5.9,

Achtung: Wird mit JDK 1.4.x gearbeitet, muss zusätzlich noch das Paket Tomcat 5.5.9 Compat (jakarta-tomcat-5.5.9-compat.zip) heruntergeladen werden und nach der Installation von Tomcat in das Tomcat-Installationsverzeichnis (z.B. „C:\Programme\Apache Software Foundation\Tomcat 5.5“) entpackt werden.

Installation des JDK 5.0

Installieren Sie zunächst das JDK 5.0 auf Ihrem System. Anschließend fügen Sie der Path-Umgebungsvariablen den Pfad zum JDK\bin-Verzeichnis hinzu (z.B. Path=…;C:\Programme\Java\j2sdk1.5.0_04\bin), um den Compiler z.B. in der Eingabeaufforderung benutzen zu können. Sie können prüfen, ob das korrekt geschehen ist, indem Sie in der Eingabeaufforderung nacheinander die beiden Befehle

• java –version und
• javac –help

Installationsanleitung für Tomcat 5.5.9 (ausführbare Installationsdatei)

Führen Sie die Datei jakarta-tomcat-5.5.9.exe aus, die die Tomcat-Installation auf Ihrem System durchführt.

Nach erfolgreicher Installation kann nun über „Start --> Programme --> Apache Tomcat 5.5 --> Configure Tomcat“ Tomcat gestartet und gestoppt werden sowie u.a. eingestellt werden, ob das Starten automatisch bei jedem Windowsstart oder manuell erfolgen soll.

Um zu testen, ob Sie Tomcat erfolgreich auf Ihrem System installiert haben, starten sie - sofern dies noch nicht automatisch nach der Installation geschehen ist – zunächst den Tomcat-Server. Anschließend sollten Sie unter der URL http://localhost:8080 (bzw. http://127.0.0.1:8080) die Tomcat-Startseite aufrufen können, vgl. Abbildung 1. Tomcat horcht per Voreinstellung auf Port 8080, um Konflikte mit anderen Webservern, die Anfragen auf Port 80 entgegennehmen, zu vermeiden.

Installationsanleitung für Tomcat 5.5.9 (zip-Datei)

Entpacken Sie die Datei jakarta-tomcat-5.5.9.zip in ein beliebiges Verzeichnis, z.B. in „C:\Programme\Apache Software Foundation\Tomcat 5.5“. Bevor Tomcat gestartet werden kann, müssen noch einige Umgebungsvariablen angepasst bzw. erstellt werden:

• Der Pfad zum Tomcat\bin-Verzeichnis muss an die Path-Variable angehängt werden (z.B. Path=...;„C:\Programme\Apache Software Foundation\Tomcat 5.5\bin“)
• Die Variable JAVA_HOME muss neu erstellt werden und erhält als Wert den Pfad zum JDK-Verzeichnis (z.B. JAVA_HOME=C:\Programme\Java\j2sdk1.5.0_04)
• Die Variable CATALINA_HOME muss neu erstellt werden und erhält als Wert den Pfad zum Tomcat-Verzeichnis (z.B. CATALINA_HOME=„C:\Programme\Apache Software Foundation\Tomcat 5.5“)

Öffnen Sie nun über „Start --> Programme --> Zubehör --> Eingabeaufforderung“ die Eingabeaufforderung. Um Tomcat zu starten, geben Sie startup.bat ein.

Anschließend sollten Sie unter der URL http://localhost:8080 (bzw. http://127.0.0.1:8080) die Tomcat-Startseite aufrufen können, vgl. Abbildung 1. Tomcat horcht per Voreinstellung auf Port 8080, um Konflikte mit anderen Webservern, die Anfragen auf Port 80 entgegennehmen, zu vermeiden.

Um Tomcat wieder zu beenden geben Sie shutdown.bat in der Eingabeaufforderung ein.

Tomcat-Verzeichnisse

Die komplette Tomcat-Dokumentation ist unter \webapps\tomcat-docs\index.html zu finden. Hier findet man u.a. auch die Servlet API Dokumentation und die JSP API Dokumentation.

Hello World!

Nachdem Tomcat korrekt installiert ist, zeigen wir nun, wie Sie das klassische Hello World Beispiel als Webapplikation erstellen können. Die Applikation besteht nur aus einem einzigen Servlet, das die Meldung „Hello World!“ in Form eines HTML-Dokuments zurück an den Browser sendet.

Im Folgenden wollen wir mit %JavaHome% das JDK-Installationsverzeichnis (z.B. „C:\Programme\Java\j2sdk1.5.0_04“) und mit %TomcatHome% das Tomcat-Installationsverzeichnis (z.B. „C:\Programme\Apache Software Foundation\Tomcat 5.5“) bezeichnen.

Zunächst erstellen Sie in einem beliebigen Verzeichnis, z.B. in „C:\JavaProjekte“, das Servlet HelloWorld.java mit folgendem Inhalt:

import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;

public class HelloWorld extends HttpServlet {

    protected void doGet(HttpServletRequest Request,
                         HttpServletResponse Response)
                  throws ServletException, IOException {

        Response.setContentType("text/html");
        PrintWriter out = Response.getWriter();
        out.println("<html><body>Hello World!</body></html>");
    }

}

Anschließend kompilieren Sie die Datei HelloWorld.java mit dem Befehl:

javac –classpath %TomcatHome%\common\lib\servlet-api.jar HelloWorld.java

Für das Deployment der Webapplikation erstellen Sie nun die folgenden Verzeichnisse:

%TomcatHome%\webapps\HelloWorld

%TomcatHome%\webapps\HelloWorld\WEB-INF

%TomcatHome%\webapps\HelloWorld\WEB-INF\classes

Kopieren Sie die Datei HelloWorld.class, die durch das Kompilieren entstanden ist, in das Verzeichnis %TomcatHome%\webapps\HelloWorld\WEB-INF\classes und legen Sie in %TomcatHome%\webapps\HelloWorld\WEB-INF den Deployment Descriptor web.xml mit folgendem Inhalt an:

<?xml version="1.0" encoding="UTF-8"?>

<web-app xmlns="http://java.sun.com/xml/ns/j2ee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
         http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"
         version="2.4">

  <servlet>
    <servlet-name>HelloWorld</servlet-name>
    <servlet-class>HelloWorld</servlet-class>
  </servlet>


  <servlet-mapping>
    <servlet-name>HelloWorld</servlet-name>
    <url-pattern>/HelloWorld</url-pattern>
  </servlet-mapping>

</web-app>

Starten Sie nun Tomcat. Das Ergebnis sollte jetzt mit einem Browser unter http://localhost:8080/HelloWorld/HelloWorld (bzw. http://127.0.0.1:8080/HelloWorld/HelloWorld) sichtbar sein, vgl. Abbildung 2.

Installation der JSTL

In Kurseinheit 1 des Kurses 01794 wird die so genannte Java Standard Tag Library (kurz JSTL) vorgestellt. Um in einer Webapplikation die JSTL verwenden zu können, müssen die jar-Archive der JSTL in die Webapplikation integriert werden. Dazu ist im WEB-INF-Verzeichnis der Webapplikation ein Unterverzeichnis namens lib anzulegen, in welches die beiden jar-Archive

• standard.jar und
• jstl.jar

Eine Möglichkeit, sich diese Archive zu beschaffen, bietet eine Tomcat-Installation. Die jar-Archive liegen im Verzeichnis: %TomcatHome%\webapps\jsp-examples\WEB-INF\lib.
Eine andere Möglichkeit bietet das zip-Archiv jakarta-taglibs-standard-1.1.2.zip. Die Bibliotheken befinden sich im lib-Verzeichnis dieses Archivs.